home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / bin / c64kerv22b.sda / KERMIT 4.DOC < prev    next >
Text File  |  2020-01-01  |  11KB  |  397 lines
  1.  
  2.  
  3.  
  4.  
  5. ├-64/128 ╦ERMIT ╒SER'S ╟UIDE                         ╨AGE 17
  6.  
  7.  
  8. ╞ILE ╘RANSFERS: ╘RANSFERRING ╞ILES
  9.  
  10. ╘RANSFERRING FILES WITH ╦ERMIT ISN'T REALLY ANY MORE DIFFI-
  11. CULT THAN WITH MOST OTHER ├OMMODORE TELECOMMUNICATIONS
  12. PACKAGES/PROTOCOLS.  ╔N FACT, ╦ERMIT IS MUCH MORE FLEXIBLE--
  13. BUT FLEXIBILITY CAN BE CONFUSING.
  14.  
  15. ╘HERE ARE THREE MAJOR PARAMETERS TO BE CONCERNED WITH WHEN
  16. TRANSFERRING FILES.  ╘HEY ARE: 1) ╞ILE-TYPE, 2) ╞ILE-BYTE-
  17. SIZE, AND 3) ┼IGHT-BIT-QUOTING.  ╠ET'S DISCUSS EACH OF THEM
  18. IN TURN, BEGINNING WITH ╞ILE-TYPE.
  19.  
  20.  
  21.   ├HOOSING THE ├ORRECT ╞ILE-TYPE
  22.  
  23. ╦ERMIT CURRENTLY SUPPORTS FIVE DIFFERENT FILE TYPES. ╘HEY
  24. ARE:
  25.  
  26.     A) ┴╙├╔╔
  27.     B) ┬INARY
  28.     C) ├-╨OWER
  29.     D) ╨┼╘╙├╔╔
  30.     E) ╙CRIPT
  31.  
  32. ┼ACH OF THESE FILE TYPES HAS A DISTINCT USE.  ╫HEN TO USE
  33. ONE FILE-TYPE OVER ANOTHER CAN BE CONFUSING INITIALLY.  ╙O,
  34. WE'LL DISCUSS EACH OF THEM SEPARATELY, STARTING WITH ┴╙├╔╔.
  35.  
  36.     ┴╙├╔╔ ╞ILE-TYPE
  37.  
  38. ╘HIS FILE-TYPE IS USED A LOT LESS OFTEN THAN YOU MIGHT THINK
  39. AT FIRST.  ┬ECAUSE ├OMMODORE COMPUTERS (EXCEPT FOR THE ┴MI-
  40. GAS AND ╨├S) USE THEIR OWN, MODIFIED CHARACTER SET ARRANGE-
  41. MENT (╨┼╘╙├╔╔), MOST TEXT FILES YOU TRANSFER TO AND FROM
  42. YOUR ├OMMODORE WILL BE ╨┼╘╙├╔╔ FILES, NOT STANDARD ┴╙├╔╔.
  43.  
  44. ┘OU WILL USE THIS FILE-TYPE ONLY WHEN YOU A) WISH TO DOWN-
  45. LOAD A STANDARD ┴╙├╔╔ FILE AND ╬╧╘ CONVERT IT TO A FORM
  46. USABLE ON YOUR ├OMMODORE (╨┼╘╙├╔╔), OR B) YOU HAVE, FOR SOME
  47. REASON, A STANDARD ┴╙├╔╔ FILE THAT YOU WISH TO UPLOAD TO
  48. ANOTHER COMPUTER.
  49.  
  50. ╔F YOU HAPPEN TO CHOOSE THIS FILE-TYPE WHEN YOU REALLY
  51. NEEDED ╨┼╘╙├╔╔, YOU WILL BE ABLE TO TELL IMMEDIATELY, AS THE
  52. CASE OF ALL THE TEXT WILL BE REVERSED.
  53.  
  54.     ┬INARY ╞ILE-TYPE
  55.  
  56. ╘HE ┬INARY FILE-TYPE IS NOT USED AS OFTEN AS SOME OF THE
  57. OTHER FILE-TYPES.  ╘HIS FILE-TYPE IS USED TO TRANSFER ├OMMO-
  58. DORE PROGRAMS THAT ARE EXECUTABLE (I.E. A ┬┴╙╔├ PROGRAM OR A
  59. MACHINE LANGUAGE GAME), OR MEMORY IMAGES SUCH AS GRAPHICS
  60. SCREENS.  ╔N OTHER, MORE TECHNICAL, TERMS, THIS FILE-TYPE
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71. ╨AGE 18                         ├-64/128 ╦ERMIT ╒SER'S ╟UIDE
  72.  
  73.  
  74. ALLOWS YOU TO TRANSFER FILES WITHOUT PERFORMING ANY CHARAC-
  75. TER TRANSLATION.  ╬OTE THAT IT'S GENERALLY A GOOD IDEA TO
  76. HAVE ┼IGHT-BIT-QUOTING SET ON WHEN TRANSFERRING BINARY
  77. FILES, BUT MORE ABOUT THAT BELOW.
  78.  
  79.     ├-╨OWER ╞ILE-TYPE
  80.  
  81. ╘HIS FILE-TYPE IS DESIGNED SPECIFICALLY TO TRANSFER SOURCE
  82. CODE FILES FOR USE WITH THE ├ ╨OWER (NOW SOLD AS ╨OWER ├) ├
  83. COMPILER FOR THE ├-64 AND ├-128.  ├ ╨OWER FILES HAVE, IN
  84. ADDITION TO THE STANDARD ╨┼╘╙├╔╔ FILE-TYPE BASE, A FEW RE-
  85. DEFINED CHARACTERS THAT ARE NEEDED FOR ├ PROGRAMMING, SUCH
  86. AS BRACES, THE UNDERSCORE, THE PIPE, ETC.
  87.  
  88. ╫HEN YOU USE THIS FILE-TYPE, ANY STANDARD ├ SOURCE CODE
  89. FILES YOU DOWNLOAD TO YOUR ├OMMODORE WILL BE CONVERTED TO ├
  90. ╨OWER FORMAT.  ╧N THE OTHER SIDE OF THE COIN, ANY ├ ╨OWER
  91. FILES YOU UPLOAD TO ANOTHER COMPUTER WILL BE CONVERTED TO
  92. STANDARD ┴╙├╔╔ SOURCE CODE FILES.
  93.  
  94.     ╨┼╘╙├╔╔ ╞ILE-TYPE
  95.  
  96. ╘HIS FILE-TYPE IS THE MOST COMMON FILE-TYPE, AND SO IT IS
  97. THE DEFAULT ╦ERMIT FILE-TYPE.  ╫HEN YOU USE THIS FILE-TYPE,
  98. ANY ├OMMODORE TEXT FILE YOU UPLOAD TO ANOTHER COMPUTER WILL
  99. BE CONVERTED TO STANDARD ┴╙├╔╔ TEXT.  ╟OING THE OTHER DIREC-
  100. TION, WHEN YOU DOWNLOAD A STANDARD ┴╙├╔╔ TEXT FILE TO YOUR
  101. ├OMMODORE, IT WILL BE TRANSLATED TO ╨┼╘╙├╔╔.
  102.  
  103. ╔F YOU CHOOSE THIS FILE TYPE WHEN YOU REALLY MEANT ┴╙├╔╔,
  104. THE CASE OF ALL THE LETTERS IN THE TEXT WILL BE REVERSED.
  105.  
  106.     ╙CRIPT ╞ILE-TYPE
  107.  
  108. ╘HIS IS A SPECIAL FILE-TYPE FOR USE WHEN TRANSFERRING FILES
  109. FOR THE ├OMMODORE ╙PEEDSCRIPT WORD PROCESSOR (├OMPUTE! ╨UB-
  110. LICATIONS).  ╙PEEDSCRIPT FILES HAVE A SPECIAL FILE FORMAT.
  111. ╔F YOU WANT TO DOWNLOAD A STANDARD TEXT FILE FROM ANOTHER
  112. COMPUTER FOR ╙PEEDSCRIPT, YOU MUST USE THIS FORMAT.  ╘HE
  113. SAME APPLIES FOR SENDING A ╙PEEDSCRIPT FILE TO ANOTHER COM-
  114. PUTER THAT USES STANDARD ┴╙├╔╔ TEXT FILES.  ╬OTE THAT NO
  115. ATTEMPT IS MADE TO TRANSLATE ANY OF ╙PEEDSCRIPT'S SPECIAL
  116. TEXT FORMATTING OR CONTROL CODES-- YOU WILL HAVE TO MAKE THE
  117. APPROPRIATE CHANGES MANUALLY.
  118.  
  119.  
  120.   ╙ETTING THE ╞ILE-BYTE-SIZE
  121.  
  122. ╘HIS PARAMETER IS OFTEN CONFUSING BECAUSE IT SOUNDS A LOT
  123. LIKE THE ╫ORD-SIZE PARAMETER.  ╘HESE TWO PARAMETERS ARE
  124. ACTUALLY QUITE DIFFERENT.  ╫HEREAS ╫ORD-SIZE DESCRIBES THE
  125. WIDTH OF THE DATA PATH, ╞ILE-BYTE-SIZE DESCRIBES THE SIZE OF
  126. THE DATA WORDS WITHIN FILES BEING TRANSFERRED.
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137. ├-64/128 ╦ERMIT ╒SER'S ╟UIDE                         ╨AGE 19
  138.  
  139.  
  140. ╘HIS PARAMETER CAN ALWAYS BE LEFT SET TO ┼╔╟╚╘-┬╔╘.  ╘ECHNI-
  141. CALLY, IT IS REALLY ONLY NECESSARY TO BE SET TO ┼╔╟╚╘-┬╔╘
  142. WHEN YOU ARE TRANSFERRING ┬INARY OR ╨┼╘╙├╔╔ FILES.
  143.  
  144.  
  145.   ╒SING ┼IGHT-BIT-QUOTING
  146.  
  147. ╘HIS FEATURE ALLOWS YOU TO TRANSFER ┬INARY OR ╨┼╘╙├╔╔ FILES
  148. TO AND FROM COMPUTERS THAT WOULD NORMALLY BE UNABLE TO HAN-
  149. DLE THEM.  ┼IGHT-BIT-QUOTING ALLOWS YOU TO SEND FILES WITH
  150. EIGHT-BIT DATA WORDS OVER A SEVEN-BIT DATA PATH.  ╘HIS
  151. PARAMETER CAN ALWAYS BE LEFT SET TO ╧╬.
  152.  
  153. ╞OR INSTANCE, ╔ OFTEN COMMUNICATE WITH A MACHINE WHERE MY
  154. COMMUNICATIONS PARAMETERS HAVE TO BE ╫ORD-SIZE OF ╙EVEN-BIT
  155. AND ┼VEN ╨ARITY.  ╔N THIS KIND OF ENVIRONMENT ╔ WOULD NOR-
  156. MALLY BE UNABLE TO SEND A PROGRAM FILE TO A FRIEND ON THAT
  157. MACHINE, AS PROGRAM FILES ARE ┬INARY (EIGHT-BITS).  ┬UT IF ╔
  158. MAKE SURE ┼IGHT-BIT-QUOTING IS ╧╬, EVERYTHING WILL BE FINE.
  159.  
  160. ╘ECHNICALLY, ┼IGHT-BIT-QUOTING PREFIXES EACH BYTE OF DATA
  161. THAT IS OVER SEVEN BITS LONG (GREATER THAN ┴╙├╔╔ 127 DECIMAL
  162. IN VALUE) SO THAT IT CAN BE TRANSFERRED ALONG A SEVEN-BIT
  163. DATA PATH.
  164.  
  165.  
  166.   ╙PECIAL ╞ILE-╘RANSFER ═ODE ╞EATURES
  167.  
  168. ╘HERE ARE THREE HELPFUL FEATURES AVAILABLE WHEN TRANSFERRING
  169. FILES.  ╘HESE FEATURES ARE STANDARD IN MOST VERSIONS OF ╦ER-
  170. MIT.  ╘HEY ARE:
  171.  
  172.     ╦EY ╙EQUENCE   ┴CTION
  173.  
  174.     <╥┼╘╒╥╬>       ╞ORCE LOCAL ╦ERMIT TO RE-SEND CURRENT PACKET
  175.     <├╘╥╠> - <╪>   ├ANCEL TRANSMISSION OF CURRENT FILE
  176.     <├╘╥╠> - <┘>   ├ANCEL TRANSMISSION OF ENTIRE BATCH OF FILES
  177.  
  178. ┴LL OF THESE COMMANDS ARE AVAILABLE WHEN RECEIVING A FILE OR
  179. FILES.  ┬ECAUSE ├-64/128 ╦ERMIT CAN'T SEND MORE THAN ONE
  180. FILE PER ╙┼╬─ COMMAND (A FEATURE CALLED "WILDCARD SEND"),
  181. THE <├╘╥╠> - <┘> FEATURE IS NOT APPLICABLE WHEN SENDING A
  182. FILE.
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203. ╨AGE 20                         ├-64/128 ╦ERMIT ╒SER'S ╟UIDE
  204.  
  205.  
  206. ╥EFERENCE: ├OMMAND ─ESCRIPTIONS
  207.  
  208.  
  209.  
  210.   ├OMMAND ╠IST
  211.  
  212.  
  213. ╦ERMIT V2.2 HAS 16 MAJOR COMMANDS, MANY OF WHICH HAVE SUB-
  214. OPTIONS.  ┬ELOW IS A LIST OF THE MAJOR COMMANDS.
  215.  
  216.     ┬YE    ├ONNECT   ─IRECTORY   ─ISK      ┼XIT      ╞INISH
  217.     ╟ET    ╚ELP      ╤UIT        ╥ECEIVE   ╥ESTORE   ╙AVE
  218.     ╙END   ╙ET       ╙HOW        ╙TATUS
  219.  
  220.  
  221.   ├OMMAND ╙UMMARY
  222.  
  223. ┼ACH OF THE MAJOR COMMANDS ARE DESCRIBED BELOW IN ALPHABETI-
  224. CAL ORDER.  ╞OLLOWING THE DESCRIPTION IS ONE OR MORE EXAM-
  225. PLES USING THE COMMAND PREVIOUSLY DESCRIBED.  ╨LEASE NOTE
  226. THAT ALL COMMANDS MAY BE ENTERED IN EITHER LOWER OR UPPER
  227. CASE-- CASE DISTINCTION IS NOT MADE BY THE ╦ERMIT PARSER.
  228.  
  229.     ┬YE
  230.  
  231. ╘HIS COMMAND CAUSES ├-64/128 ╦ERMIT TO TELL THE REMOTE ╦ER-
  232. MIT, WHICH MUST BE IN SERVER MODE, TO EXIT AND, IF APPLICA-
  233. BLE, TERMINATE ITS JOB (OR PROCESS, ETC.).  ╘HE REMOTE ╦ER-
  234. MIT THEN CLOSES THE CONNECTION.  ├-64/128 ╦ERMIT FINISHES BY
  235. EXITING TO ┬┴╙╔├.  ┬YE HAS NO ARGUMENTS, WITH THE FORMAT:
  236.  
  237. ╦ERMIT-65>BYE
  238.  
  239.     ├ONNECT
  240.  
  241. ╘HE ├╧╬╬┼├╘ COMMAND PUTS ╦ERMIT INTO ├ONNECT ═ODE (SEE THE
  242. ╔NTRODUCTION TO ╦ERMIT SECTION FOR MORE INFORMATION ON ├ON-
  243. NECT ═ODE).  ╦ERMIT CAN THEN BEGIN COMMUNICATION WITH
  244. ANOTHER COMPUTER AS A TERMINAL (AS DEFINED BY THE ╙┼╘
  245. ╘┼╥═╔╬┴╠-┼═╒╠┴╘╔╧╬ COMMAND).  ├ONNECT HAS NO ARGUMENTS, WITH
  246. THE FORMAT:
  247.  
  248. ╦ERMIT-65>CONNECT
  249.  
  250. ╘O RETURN TO ├OMMAND ═ODE (SEE THE ╔NTRODUCTION TO ╦ERMIT
  251. SECTION FOR MORE INFORMATION ON ├OMMAND ═ODE), TYPE THE
  252. ESCAPE CHARACTER FOLLOWED BY A <"C">.  ╘HE DEFAULT ESCAPE
  253. CHARACTER IS <├╘╥╠> - <┘>.  ╘HE ESCAPE CHARACTER MAY BE FOL-
  254. LOWED BY CHARACTERS OTHER THAN <"C">.  ╘HE OTHER VALID
  255. OPTIONS AND WHAT THEY DO CAN BE VIEWED BY SUBSTITUTING A
  256. <"?"> FOR THE <"C">, GIVING THE FOLLOWING DISPLAY:
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269. ├-64/128 ╦ERMIT ╒SER'S ╟UIDE                         ╨AGE 21
  270.  
  271.  
  272.     ╧NE OF THE FOLLOWING:
  273.     ?             - THIS HELP MESSAGE.
  274.     B             - SEND A BREAK SIGNAL.
  275.     C             - CLOSE THE CONNECTION.
  276.     S             - STATUS OF CONNECTION.
  277.     0             - SEND A NULL.
  278.     ESCAPE-CHAR   - TRANSMIT THE ESCAPE CHARACTER.
  279.  
  280.     ─IRECTORY
  281.  
  282. ╘HE ─╔╥┼├╘╧╥┘ COMMAND RETURNS A DISK DIRECTORY OF THE SPECI-
  283. FIED FILES ON DEVICE 8 (THE NORMAL DEVICE NUMBER FOR THE
  284. FIRST SERIAL ├OMMODORE DISK DRIVE).  ─╔╥┼├╘╧╥┘ WITH NO ARGU-
  285. MENTS RETURNS A COMPLETE DISK DIRECTORY.  ╘HE DIRECTORY MAY
  286. BE PAUSED BY PRESSING <╙╨┴├┼> AND RESUMED BY PRESSING ANY
  287. KEY, AND ABORTED BY PRESSING <╙╘╧╨>.  ╘HE FORMAT IS:
  288.  
  289. ╦ERMIT-65>DIRECTORY [FILENAME]
  290.  
  291. WHERE [FILENAME] IS A VALID ├┬═ ─╧╙ FILENAME.  ╙OME EXAM-
  292. PLES:
  293.  
  294.     ╦ERMIT-65>DIRECTORY        (DIRECTORY OF ALL FILES
  295.                                ON DEVICE 8)
  296.  
  297.     ╦ERMIT-65>DIRECTORY KER*   (DIRECTORY OF FILES BE-
  298.                                GINNING WITH "KER")
  299.  
  300.     ╦ERMIT-65>DIRECTORY K?W    (DIRECTORY OF FILES 3
  301.                                CHARACTERS LONG, BEGIN-
  302.                                NING WITH "K" AND ENDING
  303.                                WITH "W")
  304.  
  305.     ─ISK
  306.  
  307. ╘HE ─╔╙╦ COMMAND ALLOWS YOU TO SEND ─╧╙ COMMANDS DIRECTLY TO
  308. THE DISK DRIVE CONTROLLER.  ╘HIS COMMAND IS USEFUL FOR INI-
  309. TIALIZING THE DRIVE, FORMATTING A DISK, AND DELETING
  310. UNWANTED FILES.  ╘HIS COMMAND SUPPORTS ALL THE STANDARD ├OM-
  311. MODORE ─╧╙ COMMANDS, EXCEPT THAT ╬╧ SPACES IN FILENAMES ARE
  312. ALLOWED.  ╘HIS IS ACTUALLY A "FEATURE" OF THE PARSER AND
  313. WILL BE CORRECTED IN A FUTURE VERSION.  ─╔╙╦ WITH NO ARGU-
  314. MENTS WILL RETURN THE DRIVE ERROR IN STANDARD ─╧╙ FORMAT IF
  315. THE DRIVE'S RED LIGHT IS BLINKING.  ╘HE FORMAT IS:
  316.  
  317. ╦ERMIT-65>DISK [STRING]
  318.  
  319. WHERE [STRING] IS A VALID ├┬═ ─╧╙ COMMAND.  ╙OME EXAMPLES:
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335. ╨AGE 22                         ├-64/128 ╦ERMIT ╒SER'S ╟UIDE
  336.  
  337.  
  338.     ╦ERMIT-65>DISK S0:K*         (DELETE ALL FILES BEGIN-
  339.                                  NING WITH "K" ON DEVICE
  340.                                  8)
  341.  
  342.     ╦ERMIT-65>DISK I0:           (INITIALIZE DEVICE 8)
  343.  
  344.     ╦ERMIT-65>DISK N0:FILES,01   (FORMAT DISK IN DEVICE 8,
  345.                                  GIVING IT NAME "FILES"
  346.                                  AND ID "01"-- NOTE THE
  347.                                  LACK OF SPACES IN THE
  348.                                  DISK NAME CHOSEN)
  349.  
  350.     ┼XIT
  351.  
  352. ╘HE ┼╪╔╘ COMMAND CAUSES ├-64/128 ╦ERMIT TO STOP EXECUTION
  353. AND RETURN CONTROL OF THE MACHINE TO ┬┴╙╔├.  ╘HIS COMMAND IS
  354. THE SAME AS THE ╤╒╔╘ COMMAND.  ╦ERMIT MAY BE RESTARTED
  355. IMMEDIATELY WITH THE COMMAND ╥╒╬.  ╔F YOU TYPE ╬┼╫, ╦ERMIT
  356. CAN STILL BE RESTARTED MOST OF THE TIME WITH THE COMMAND ╙┘╙
  357. 2064.  ┼XIT HAS NO ARGUMENTS.  ╘HE FORMAT OF THIS COMMAND
  358. IS:
  359.  
  360. ╦ERMIT-65>EXIT
  361.  
  362.     ╞INISH
  363.  
  364. ╘HIS COMMAND CAUSES ├-64/128 ╦ERMIT TO TELL THE REMOTE ╦ER-
  365. MIT, WHICH MUST BE IN SERVER MODE, TO EXIT.  ╫HEN ├-64/128
  366. ╦ERMIT RECEIVES THE ACKNOWLEDGEMENT THAT THIS IS BEING DONE,
  367. YOU ARE PROMPTED FOR ANOTHER COMMAND.  ╞INISH HAS NO ARGU-
  368. MENTS, WITH THE FORMAT:
  369.  
  370. ╦ERMIT-65>FINISH
  371.  
  372.     ╟ET
  373.  
  374. ╘HIS COMMAND CAUSES ├-64/128 ╦ERMIT TO REQUEST THAT THE
  375. OTHER ╦ERMIT (WHICH MUST BE RUNNING IN SERVER MODE) TO
  376. TRANSMIT THE SPECIFIED FILE TO THE ├-64/128 ╦ERMIT.  ╘HE
  377. FORMAT OF THIS COMMAND IS:
  378.  
  379. ╦ERMIT-65>GET [FILE-SPECIFICATION]
  380.  
  381. WHERE [FILE-SPECIFICATION] IS A VALID FILE SPECIFICATION FOR
  382. THE SYSTEM ON WHICH THE OTHER ╦ERMIT IS RUNNING.
  383.  
  384.     ╤UIT
  385.  
  386. ╘HIS COMMAND CAUSES ├-64/128 ╦ERMIT TO STOP EXECUTION AND
  387. RETURN CONTROL OF THE MACHINE TO ┬┴╙╔├.  ╤╒╔╘ IS IDENTICAL
  388. TO THE ┼╪╔╘ COMMAND (SEE ┼╪╔╘ ABOVE FOR MORE INFORMATION).
  389. ╤╒╔╘ HAS NO ARGUMENTS.  ╘HE FORMAT THIS COMMAND IS:
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.